home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 2.iso / BARNET / COMPILER / SATHER / !Sather / !Help < prev    next >
Text File  |  1997-06-19  |  3KB  |  102 lines
  1.  
  2.  
  3. Sather 1.1 Compiler Risc OS version
  4.  
  5. Compiler and Boehm garbage collector ported from Unix version by
  6. Peter Naulls 1997
  7.  
  8. Front-End by Peter Naulls 1997
  9.  
  10. pnaulls@wave.co.nz
  11.  
  12.  
  13. This help file does not document either the Sather compiler
  14. or the Sather language.  For more information see:
  15.  
  16.  - The !Sather.Docs directory.
  17.  - The RISC OS Sather homepage: http://www.cs.waikato.ac.nz/~pnaulls/sather/
  18.  - The Sather homepage: http://www.icsi.berkeley.edu/~sather/
  19.  
  20.  
  21. You will require the following:
  22.  
  23.  - A C compiler
  24.  
  25.  Almost certainly GCC, Acorn's C compiler may not work with Sather.
  26.  This is configured in !Sather.System.Common.CONFIG
  27.  
  28.  - UnixLib
  29.  
  30.  Version 3.7b, older versions will break under StrongARM.
  31.  
  32.  - A Make utility
  33.  
  34.  The default is amu, but others are likely to work.
  35.  Also configured in CONFIG.
  36.  
  37.  - Lots of memory
  38.  
  39.  Hello World requires 9Mb to compile in with seperate compilation
  40.  (-only_C).  The Compiler will also support Virtualise by putting
  41.  the heap in dynamic areas if you do:
  42.  
  43.  Set cs_heap ""
  44.  
  45.  This is done automatically for you if you select "Use Dynamic areas"
  46.  from the front end.
  47.  
  48.  
  49. Front End
  50.  
  51.  Drag a Sather program (.sa) or module (.sam or .module) to the File
  52.  writable icon.  (This will be shift-drag if, like me, you use
  53.  a module which lets you insert the contents of text files in writable
  54.  icons).
  55.  
  56.  The Main Class icon adds the -main flag to the command line.
  57.  
  58.  I suggest you use the Only C option, as amu/gcc will take memory
  59.  _on top_ of the Sather compiler - there may be an option at a later
  60.  date to run this afterwards.  For now, you will want to run amu
  61.  separately.
  62.  
  63.  Other options should be obvious - if not, then email me and tell me so :)
  64.  
  65.  
  66. Risc OS notes:
  67.  
  68.  - Filenames can be specified as either filename.sa sa.filename or filename/sa
  69.  - The extension for module files is /sam or /module.
  70.  - Make sure you specifiy the full path for input files eg.
  71.  
  72.     cs /temp/sa.hw -o hw -main HELLO_WORLD
  73.  
  74.       not
  75.  
  76.    cs sa.hw -o hw -main HELLO_WORLD
  77.  
  78.    (Slight bug I will fix)
  79.  
  80.  - The compiler only understands Unix filenames at present, not Risc OS
  81.    ones (apart from the sa. exception mentioned above)
  82.  
  83.  
  84. Bugs:
  85.  
  86.  A few bugs are still known to exist.  In particular, the internal
  87.  name mangler is known to crash on occasion.  Secondly, the
  88.  'o' directory and runtime.c will not be created or copied respectively
  89.  if the current directory is not where the C source files are created.
  90.  
  91.  Any others; please, please, report to me.
  92.  
  93.  
  94. Thanks to:
  95.  
  96. Keith Hopper, John Newman, James Shiell
  97. and those on the comp.lang.sather newsgroup.
  98.  
  99.  
  100.  
  101.  
  102.